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for a Ring 3 library 



j More people think they can write an 
Application than they can write a driver 

j Not all devices need a driver for system 
integration 

j Help testing in driver development 
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Design goals 

ill 


T 

j Easy to use 

L 

• Support all transfer types 

@ 

© Usable by multiple Applications 

• Provide information about devices 


m PNP Support 


\ 

) 
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Feature List for USBCALLS 

o Transfers Types 
• Control 

L 

j Bulk 

@ 

• Isochronous 

• Interrupt 

E 

o Notification about Device de/attach 


g Number of Devices 


\ 

-J 

G Device Reports 



o REXX interface 














System Information 

UsbQueryNumberDevices 
ULONG *pulNumDev 

UsbQueryDeviceReport 
ULONG ulDevNumber 
ULONG *ulBufLen 
CHAR *pData 



UsbRegisterChangeNotification 
PUSBNOTIFY pNotifylD 
HEV hDeviceAdded 
HEV hDeviceRemoved 


UsbDeregisterNotification 
USBNOTIFY NotifylD 
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UsbRegisterDeviceNotification 
PUSBNOTIFY pNotifylD 
HEV hDeviceAdded 
HEV hDeviceRemoved 
USHORT us Vendor 
SHORT usProduct 
SHORT usBCDVersion 



Open/ Close Cals 

UsbOpen 

PUSBHANDLE pHandle 
USHORT us Vendor 
USHORT usProduct 
USHORT usBCDDevice 
USHORT usEnumDevice 

UsbClose 

USBHANDLE Handle 
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Control Transfers 

UsbCtrlMessage 
USBHANDLE Handle 
UCHAR ucRequestType 
UCHAR ucRequest 
USHORT us Value 
USHORT uslndex 
USHORT usLength 
UCHAR *pData 
ULONG ulTimeout 
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Standard Control 


r 



r n 

T o UsbDeviceSetConfiguration 
• UsbGetStringDescriptor 
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Bulk Transfers 

UsbBulkRead 
USBHANDLE Handle 
UCHAR Endpoint 
UCHAR Interface 
USHORT *usNumBytes 
UCHAR *pData 
ULONG ulTimeout 



Bulk Transfers cunt. 

UsbBulkWrite 
USBHANDLE Handle 
CHAR Endpoint 
CHAR Interface 
SHORT usNumBytes 
CHAR *pData 
ONG ulTimeout 
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Interrupt Transfers 

UsblrqStart 
USBHANDLE Handle 
UCHAR Endpoint 
UCHAR Interface 
USHORT usNumBytes 
UCHAR *pData 
PHEV pHevModified 
UsblrqStop 
USBHANDLE Handle 
HEY HevModified 



UsblsoStart 
USBHANDLE Handle 
CHAR Endpoint 
CHAR Interface 
ISOHANDLE *phIso 

UsblsoStop 
SOHANDLE hlso 
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Iso Ringbuffer Access 

UsblsoDequeue 
ISOHANDLE hlso 
UCHAR * pBuffer 
ULONG ulNumBytes 



UsblsoEnqueue 
ISOHANDLE hlso 
const UCHAR * pBuffer 
ULONG ulNumBytes 
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UsblsoPeekQueue 
ISOHANDLE hlso 
UCHAR * pByte 
ULONG ulOffset 




UsblsoGetLength 
ISOHANDLE hlso 
ULONG *pulLength 
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jRLEXX Interface 



j Same Function Set 
j Loaded with UsbLoadFuncs 

j Rx Prefix to name 
RxUsbQueryNumberDevices etc. 
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Register for 


otiiication 


rc =DosCreateEventSem(NULL,&pRadio->hRadioPluged,0,FALSE); 
if (!rc) 

({ 

rc = DosCreateEventSem(NULL,&pRadio->hRadioUnpluged,0,FALSE); 
if (rc) 

DosCloseEventSem(pRadio->hRadioPluged); 
else 
{ 

SEMRECORD aSems[2]; 

aSems[0].hsemCur = (HSEM)pRadio->hRadioPluged; 
aSems[0].ulUser = 0; 

aSems[1].hsemCur = (HSEM)pRadio->hRadioUnpluged; 
aSems[1].ulUser = 1; 

rc — DosCreateMuxWaitSem(NULL, SpRadio->hMuxWait, 2, 

(PSEMRECORD) SaSems , DCMW_WAIT_ANY) ; 

if (!rc) 

{ 

pRadio->hMonThread = _beginthread(NotifyThread,NULL,8192,pRadio); 
rc = g_USBFuncs.pUsbRegisterDeviceNotification( &pRadio->NotifyID, 

pRadio->hRadioPluged, 
pRadio->hRadioUnpluged, 
0x04b4, 0x1002, 
USB_ANY_PRODUCTVERSION) ; 
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fotification Thread 





void _Optlink NotifyThread(void* args) 

{ 

PRADIOPRIVATE pRadio = (PRADIOPRIVATE) args ; 

ULONG ulWhich; 

ULONG ulCnt; 

pRadio->ulState |= RADIO_USBCHECK; 
while (pRadio->ulState & RADIO_USBCHECK) 

{ 

DosWaitMuxWaitSem(pRadio->hMuxWait,SEM_INDEFINITE_WAIT,SulWhich); 
if (!pRadio->ulState) 
break; 
if (ulWhich) 

{ 

ProcessRadioUnpluged(pRadio); 

DosResetEventSem(pRadio->hRadioPluged, SulCnt); 

) 

else 

{ 

ProcessRadioPluged(pRadio); 

DosResetEventSem(pRadio->hRadioPluged, SulCnt); 

} 

) 

g_USBFuncs.pUsbDeregisterNotification(pRadio->NotifyID); 

DosCloseMutexSem(pRadio->hMuxWait); 

DosCloseEventSem(pRadio->hRadioPluged); 

DosCloseEventSem(pRadio->hRadioUnpluged); 
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ProcessRadioPlugged 

void ProcessRadioPluged(PRADIOPRIVATE pRadio) 

{ 

APIRET rc; 

if (!pRadio->ulNuinRadios) 

{ 

if (pRadio->Setup.fOnOnAttach) 

{ 

DosBeep(220,50); 

DosBeep(440,50) ; 
pRadio->Setup.fTurnOn = TRUE; 

DosPostEventSem(pRadio->hEvtFreqChange); 

} 

} 

pRadio->ulNumRadios++; 

WinlnvalidateRegion(pRadio->pWidget->hwndWidget, NULL, TRUE); 

} 
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Frequency Thread 





void _Optlink FreqThread(void* args) 

{ 

PRADIOPRIVATE pRadio = (PRADIOPRIVATE) args; 

ULONG ulCnt; 

while (pRadio->ulState & RADIO_USBCHECK) 

{ 

DosWaitEventSem(pRadio->hEvtFreqChange, SEM_INDEFINITE_WAIT); 
if (!pRadio->ulState) 
break; 
do 
{ 


if(pRadio->ulNumRadios && 
pRadio->Setup.fTurnOn) 

{ 

XSTRING strSetup; 

RadioSetFreq(pRadio->Setup.ulCurrentFreq); 

WinlnvalidateRect(pRadio->pWidget->hwndWidget,NULL, FALSE); 

DosSleep(80); 
if(RadioGetStereo()) 

{ 

pRadio->ulState |= RADIO_STEREO; 

pRadio->ulState &— ~RADIO_SCAN; // End Scanning if we tuned in. 

> 
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Raciiosetf rec 


n. 



APIRET RadioSetFreq(ULONG ulNewFreq) 

{ 

double dFreq; 

ULONG ulFreq; 

USBHANDLE Handle; 

APIRET rc; 

UCHAR ucData[8] ; 

dFreq = ulNewFreq / 100.0; 

ulFreq = ((dFreq+10.7)*80); 



rc = g_USBFuncs.pUsbOpen( SHandle, 

0x04b4, 

0x1002, 

USB_ANY_PRODUCTVERSION, 

USB_OPEN_FIRST_UNUSED) ; 

if (!rc) 

{ 

rc = g_USBFuncs.pUsbCtrlMessage( Handle, 

OxCO, 0x01, 
ulFreq»8,ulFreq, 

1, (UCHAR*) SucData, 

0 ) ; 

g_USBFuncs.pUsbClose(Handle); 

) 

return(rc); 
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BOOL RadioGetStereo() 

{ 

USBHANDLE Handle; 

APIRET rc; 

UCHAR ucData[8]; 

BOOL fStereo = FALSE; 

rc = g_USBFuncs.pUsbOpen( SHandle, 

0x04b4, 

0x1002, 

USB_ANY_PRODUCTVERSION, 
USB_OPEN_FIRST_UNUSED) ; 

if (! rc) 

{ 

rc = g_USBFuncs.pUsbCtrlMessage( Handle, 

OxCO, 0x00, 

0, 0x00, 

1,(UCHAR*)SucData, 

0 ) ; 

fStereo = (ucData[0]SOxOl)==0x00; 
g_USBFuncs.pUsbClose(Handle); 

) 

return(fStereo); 
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RadloPower 


APIRET RadioPower(BOOL fTurnOn) 

{ 

USBHANDLE Handle; 

APIRET rc; 

UCHAR ucData[8]; 

BOOL fStereo = FALSE; 

rc = g_USBFuncs . pXJsbOpen ( SHandle, 

0x04b4, 

0x1002, 

USB__ANY_PRODUCTVERSION, 

USB_OPEN_FIRST_UNUSED) ; 

if (!rc) 

{ 

rc = g_USBFuncs.pUsbCtrlMessage( Handle, 

OxCO, 0x02, 
fTurnOn?1:0, 0, 

1,(UCHAR*)SucData, 

0 ) ; 

g_USBFuncs.pUsbClose(Handle); 

} 

return(rc) ; 

) 
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'(Center Radio Widget 
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miormati om 



j General info docs etc www.usb.org 
j USB device information www.linux-usb. org 

j Sources for many linux USB drivers 
www.sourceforge.net 

j The OS/2 DDK with sources of USB drivers 
service, boulder, ibm. com/ddk/ 

j OS/2 USB Project at www.netlabs.org 

9 CVS CVSROOT=:pserver:guest@www.netlabs.org:e:/netlabs.cvs/usb 
• Contact usbguy@netlabs.org 
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